home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 11 / Mac Magazin and MacEasy Magazine CD - Issue 11.iso / Diskette Mac MAGAZIN / PrintUseMonitor 2.3 / README < prev    next >
Text File  |  1995-05-25  |  15KB  |  173 lines

  1.                 SWIIPrintUseMon Version 2.3 - Shareware fee 1UK£/2US$
  2.                 --------------------------
  3.  
  4. Greetings from Ringwood, Hampshire, England.
  5.  
  6. Background
  7. ----------
  8. This utility silently monitors the number of pages 
  9. printed and warns you when your Printer cartridge is close to running out, so that you can either refill or replace it.
  10.  
  11. This utility owes its original inspiration to Sven Jakubith’s StyleWriter II PageNum utility. PrintUseMonitor supplements rather than replaces that utility.
  12.  
  13. This program is share-ware, and is subject to the usual terms and conditions. It can be freely distributed, as long as it is distributed with all its original documentation. The author does not bear any responsibility if anything goes wrong as a result of running this programme - what do you expect for next to nothing!!? However, I have tested it on as many different machines as I can lay my hands on, and the application has also been tested by a team of Beta-testers (thanks folks). It is an application that just runs once and quits, so it does not hog any memory and should not conflict with any other applications/extensions/control panels that may be running on your machine.
  14.  
  15. Shareware Fee
  16. ____________
  17. I have discovered that even a small, simple utility like this requires a commitment of my spare time in order to support it. If you like this product, and  decide to keep it, I therefore ask you to make a token commitment yourself in the form of a shareware fee. This is 1 Pound Sterling. Obviously, I would prefer English currency but, if you find it difficult to obtain this then I will accept 2$US as the next best alternative, or the nearest equivalent in terms of your local currency, if you cannot obtain US dollars (no cheques please, otherwise I end up paying the Bank more than the value of the cheque). Please send the registration fee to :-
  18.                     Mr. S.J. Smith,
  19.                     9 Farm Close,
  20.                     Ringwood,
  21.                     Hampshire.
  22.                     BH24 1RZ
  23.                     United Kingdom
  24.  
  25. Please enclose information about yourself, especially your email
  26. address, (if you have one), and the version number of PrintUseMonitor that you have. If you send me an email address, I will say 'Hi' in return and let you know of any updates to PrintUseMonitor. 
  27.  
  28. My email address is :-
  29.          smiths@ferndown.ate.slb.com
  30.  
  31.             Steve Smith
  32. _________________________________________________
  33.  
  34. What's new in Version 2.3?
  35. ____________________
  36. Version 2.3 adds support in French for the Color StyleWriter 2400 printer, and in Dutch for the SWII printer. This version supports a number of languages, see the file "Support for other languages" if this applies to you. Version 2.3 includes support for other printers, including the "ColorStylewriter Pro" and the "Personal LaserWriter 300" printers.
  37.  
  38. This version also warns you slightly earlier that your ink cartridge is about to run out. This is when the number of pages printed reaches approximately 90% of the expected maximum cartridge life.
  39.  
  40. This application will also (optionally) show you the number of pages printed and the average print time per page (see the next section if you are interested in this feature).  
  41.  
  42. How it Works
  43. __________
  44. PrintUseMonitor examines the printer log file (called by various names depending on the type of printer you are using and the language the system has been localized to). This log file is a TeachText/SimpleText document that is created (optionally) and updated by the Printer Driver whenever a document is printed. 
  45.  
  46. Each time a document is printed, the driver adds an entry containing the number of pages that were printed, the time, the application that printed them, and so on.
  47.  
  48. PrintUseMonitor processes this file, finds all the lines that start "Number of pages printed: nnn", totals up all the pages printed and ends up with the grand total printed so far. If the total number of pages printed is greater than 90% of the expected cartridge life (default 300), a warning message is displayed in a window. If the number of pages printed is less than this number then the Application exits with no message (and without creating a window).
  49.  
  50. Optionally, if you hold down the command key while PrintUseMonitor is running, it will display the number of pages printed so far, and the average print time per page. Be sure to hold the command key down all the time it is running and not just when you launch it.
  51.  
  52. Installation
  53. _________
  54. PrintUseMonitor has to be installed in the same location as the Printer's Log file. The name of the log file and its location vary, depending on the language being used by the system. On English systems, it can be found in : "System Folder:Preferences:Printing Prefs".
  55. The log file is called by various names, depending on the type of printer that is in use "StyleWriter II Log", "Color SW Pro Log", "Color SW 2400 Log" and "LaserWriter 300 Log" for example. 
  56.  
  57. Copy PrintUseMonitor to the same location as the log file. If you cannot see the log file then the 'Keep Log file' option is probably not enabled. Go to the Chooser and select the 'Setup' button for your printer. You should see a checkbox entitled "Keep Log of Printer Usage". Ensure that this is checked. The next time you print a document, the log file will be created.
  58.  
  59. If you are running system 7, make an alias to PrintUseMonitor and move it to the ‘Startup Items’ folder. Thereafter, whenever you start your Mac,  PrintUseMonitor will check the contents of the Printer Log file and warn you if the number of pages printed exceeds the suggested maximum. Note that this is the only time it will be run in this situation. You can also run it at any other time by double clicking PrintUseMonitor.
  60.  
  61. System 6 users should install the app in the same folder as directed above, then make PrintUseMonitor the startup application using ‘Set Startup...’ from the ‘Special’ menu. 
  62.  
  63. Note that PrintUseMonitor does nothing (that is it just quits without creating a window) if the number of pages printed so far is below the maximum. It is designed to only create a window if the pages printed exceeds the maximum. In order to ensure that the installation on your machine is successful, I have included some instructions on how to test it, see the section on 'Testing the utility' later in this file. It should be stressed that PrintUseMonitor does not change the Printer file, but only reads it.
  64.  
  65. Customising the utility
  66. __________________
  67. I have set the default maximum expected cartridge life to 300. This is roughly the expected life of the Ink cartridge for the StyleWriter II printer. If you want to change it to something else, then you can do this by adding the following line to your Log file...
  68.  
  69. *** Maximum Ink Cartridge Life:xxx
  70.  
  71. (replace xxx with your new maximum)
  72.  
  73. You will need to do this if you are using a Personal LaserWriter 300 printer (expected print cartridge life is 3000 pages) or the ColorStyleWriter Pro printer (expected print cartridge life is ??? pages). You may also need to adjust these figures based on your own experience.
  74.  
  75. (The Color SW 2400 printer has 2 cartridges, one for black and white printing, the other for colour printing.  The colour cartridge prints 100 pages and the B&W cartridge prints 900 pages. The expected life here depends on hw much colour printing you do and can vary from a worst-case of 100 pages to a maximum of 1000 pages.)
  76.  
  77. Whatever new maximum you choose, PrintUseMonitor will start warning you that the cartridge is running out when the number of pages printed exceeds 90% of this figure, so you should get some advance warning.
  78.  
  79. Make sure that you get the syntax exactly as printed here, preferably copy and paste the example from this file into your Printer Log file.
  80.  
  81. When you replace or refill your printer cartridge, be sure to initialise the Log file, by removing the contents using the TeachText editor or any other text editor. Alternatively, delete the log file and a new one will be created the next time you print a document. Don't forget to customise this new file with the Maximum cartridge life, as described above.
  82.  
  83. "Cooking the Books"
  84. _______________
  85. Of course, if your Printer Log file was not initialised when you last changed your cartridge, you will have to ‘cook the books’ a bit. One way is to have a guess at how many pages you have printed so far, and then change any one of the "Number of pages printed" lines in the Printer Log file to add this number of pages. 
  86.  
  87. Printer with more than one Print cartridge
  88. __________________________________
  89. The colour printers have more than one cartridge, one for printing black, and the other to print colours. The maximum in this case should be set according to how much you typically use colour when printing. If it is mainly black and white with the occasional bit of colour then set the maximum to the expected life of the Black cartridge (or slightly higher), assuming that the black cartridge will run out first. If you mainly print in colour then you should set the maximum to slightly higher than the colour cartridge life, on the assumption that the colour cartridge should run out first. In the extreme case, assuming the cartridges are used evenly, you should set the maximum to the expected life of the Black + the colour cartridges. Hopefully, this should give you an idea of the maximum and minimum cartridge life. 
  90.  
  91. Testing the utility
  92. _______________
  93. PrintUseMonitor only creates a window if it needs to tell you something. This means that there is little or no indication that 
  94. it is working. In order to give some confidence that the utility 
  95. has been installed correctly first, try double clicking PrintUseMonitor while holding down the 'command' key. PrintUseMonitor should tell you how many pages have been printed so far.
  96.  
  97. If you want to test that it will warn you when the pages printed exceeds the maximum, edit the Printer Log file as described in the section "Cooking the Books", so that PrintUseMonitor will thank that more pages have been printed than actually have.
  98.  
  99. Now run the PrintUseMonitor application. If it is working correctly you should get a message similar to the one shown 
  100. below :-
  101.                **********************************
  102.                *                                                                *
  103.                *          WARNING: It is time to Refill         *
  104.                *          or Renew your printer                    *
  105.                *          cartridge!                                       *
  106.                *                                                                *
  107.                **********************************
  108.  
  109.                xxx pages printed out of an expected
  110.                life of 300 pages.
  111.  
  112. If you have installed PrintUseMonitor as a startup application restart your Mac now to test that this aspect also works. When
  113. you have finished testing, put your Printer Log file back
  114. to how it was.
  115.  
  116. PrintUseMonitor also handles some foreign languages and displays messages in the same language as read in the Printer Log file. See the seperate README file called "Support for other Languages" for details.
  117.  
  118. Restrictions
  119. -----------
  120. This facility only works with certain languages at the moment. I can add support for other languages, when requested to do so, although I do need to have samples of the foreign Printer Log file in order to do this, as well as a translation for the messages that I use, see the seperate README file called "Support for other Languages" for details. 
  121.  
  122. This version supports the following printers :-
  123.     StyleWriter II
  124.     ColorStyleWriter Pro
  125.     Color SW 2400
  126.     LaserWriter 300
  127.  
  128.  
  129. If you are lucky enough to have more than one of these printers, I am afraid that PrintUseMonitor will only work with one of them. If there is a demand for this feature then please email me and I will see what I can do.
  130.  
  131. PrintUseMonitor does not work with the StyleWriter 1 driver, as this driver does not have the facility to keep a log file. However, you can install the SWII driver with SW1 printers, and PrintUseMonitor will work then.
  132.  
  133. PrintUseMonitor can potentially support any printer that keeps a log file. I suspect that the LaserWriter 310 printer also supports a log file facility. I am keen to add support for these printers and would appreciate it if anyone can email me with the log files for printers that I don't yet support.
  134.  
  135. Troubleshooting
  136. --------------
  137. Most, if not all problems are due, in my experience, with the installation. If PrintUseMonitor does not work then I suggest that you work through the Installation instructions carefully and follow the "Testing" section of these instructions.
  138.  
  139. If you don't even have the ‘Printing Prefs’ folder inside the ‘Preferences’ folder inside the ‘System Folder’, then this may be because you have not installed the Printer driver properly. These folders should be created by the Printer Driver install disks, but you should also be able to create them by hand. If you do, make sure that you get the folder names exactly right!
  140.  
  141. Known Problems
  142. _____________
  143. I have noticed that the Apple StyleWriter driver does not always record the correct number of pages printed. This seems to happen whenever you print multiple copies of a document. The work-round is to edit the log file after this has happened and put the correct numbers in by hand.
  144.  
  145. If the log files gets above a certain size, you can no longer edit it using TeachText, I don't think that SimpleText suffers from this same problem. However, it is just a text file so you can use any editor on it. If you just want to reinitialise it then you can simply delete the Printer Log file and a new one will be created the next time a document is printed.
  146.  
  147. I apologise for the awful interface. It is the standard user interface that you get with Think C. I will spend the time on coding up a 'proper' Mac interface one day, when I have time.
  148. (This program was written using Think C version 6 on a 4 MB Mac Classic). 
  149.  
  150. Acknowledgments
  151. ______________
  152. I would like to thank the following people for their help in the development of this Utility :-
  153.  
  154. Max C. Wach (wach@Saint-Etienne.ate.slb.com)
  155. Ortwin Gentz (gentz@informatik.tu-muenchen.de)
  156. Carlo Corti
  157. Ulf Broomé
  158. Stu (76350.2321@CompuServe.COM)
  159. Florin Neumann (florin@quartz.geology.utoronto.ca)
  160. Pat Murray (Patrick_D._Murray@maccontent.apana.org.au)
  161. John Hogan (100332.1667@compuserve.com)
  162. Sieb Spannenburg (S.Spannenburg@inter.NL.net)
  163.  
  164. my 10 year old daughter Rachel ... for all the tea!
  165. my 8 year old son Mark ... for all the technical suggestions! 
  166. my wife Lyn ... for her patience!
  167. And many many other people for all of the useful suggestions and support. You know who you are - Thank you!
  168.  
  169. ________________________________________________
  170.  
  171. I hope you find this facility useful. Have fun!
  172.  
  173. Steve Smith